home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / graphics / brape.arj / RIP.CDC < prev    next >
Text File  |  1994-03-19  |  19KB  |  399 lines

  1. color file, default color : 7
  2.    ^8──^5──^d───────────────────────────────────────────────────────────────────^5──^8──
  3. ^2     ██████  ██   ██ ███████ ███████ ██████  ███████ ███████ ███████ ██████
  4. ^2     ██▄▄▄█▄ ██▄▄▄██ ██      ██▄▄▄▄  ██▄▄▄█▄ ██▄▄▄▄█ ██▄▄▄▄█ ██▄▄▄▄  ██▄▄▄█▄
  5. ^2     ██    █ ██      ██      ██      ██    █ ██    █ ██      ██      ██    █
  6. ^3     ^^2░░░░░░░^^0 ^^2░░^^0      ^^2░░^^0      ^^2░░░░░░░^^0 ^^2░░^^0    ^^2░^^0 ^^2░░^^0    ^^2░^^0 ^^2░░^^0      ^^2░░░░░░░^^0 ^^2░░^^0    ^^2░
  7. ^3 ^^0    ^^2▒▒▒▒▒▒▒^^0 ^^2▒▒^^0      ^^2▒▒^^0      ^^2▒▒▒▒▒▒▒^^0 ^^2▒▒^^0    ^^2▒^^0 ^^2▒▒^^0    ^^2▒^^0 ^^2▒▒^^0      ^^2▒▒▒▒▒▒▒^^0 ^^2▒▒^^0    ^^2▒
  8. ^3 ^^0    ^^2▓▓▓▓▓▓▓^^0 ^^2▓▓^^0      ^^2▓▓^^0      ^^2▓▓▓▓▓▓▓^^0 ^^2▓▓^^0    ^^2▓^^0 ^^2▓▓^^0    ^^2▓^^0 ^^2▓▓^^0      ^^2▓▓▓▓▓▓▓^^0 ^^2▓▓^^0    ^^2▓
  9. ^3 ^^0    ^^2███████^^0 ^^2██^^0      ^^2██^^0      ^^2███████^^0 ^^2██^^0    ^^2█^^0 ^^2██^^0    ^^2█^^0 ^^2██^^0      ^^2███████^^0 ^^2██^^0    ^^2█
  10. ^^0   ^8──^5──^d───────────────────────────────────────────────────────────────────^5──^8──
  11. ^e                               2    O    O    O
  12.  
  13.  
  14. ^d                            C O M P L E T E  D O C S
  15.  
  16. ^d                                   for v4.0ß
  17.  
  18. ^aContents :
  19.  
  20. ^2  1. About The Program
  21. ^2  2. Complete key description
  22. ^2  3. Ripping a graphical image
  23. ^2  4. Ripping a MOD file
  24. ^2  5. How to edit the graphics in a product
  25. ^2  6. File List
  26. ^2  7. Legal stuff
  27. ^2  8. How to contact me
  28.  
  29.  
  30. ^a1. About The Program
  31. ^2────────────────────
  32. ^fByteRaper 2000^7 was coded by ^eMaciek "LiTENiNG" Drejak^7 in ^3Borland Pascal 7.0^7.
  33. ByteRaper reads the file that you want to view directly from the hard disk
  34. to screen, so using ^3SMARTDRV.EXE^7 will increase the performance of the program
  35. drastically. It's main purpose is to view different kinds of data from
  36. miscellaneous files. It's also able to remove or edit data that you often
  37. want to get your hands on, like ^3graphics^7 and ^3music^7. Please note
  38. that this ripper cannot be used for cracking games. The latest version of
  39. Byte Raper 2000 can be downloaded at ^eDigital Laboratory +46-(0)31-267840^7.
  40.  
  41. This version of the ripper has ^35 different ways to view the file^7 :
  42.  ^e1. Graphic viewer
  43.  ^e2. Textmode viewer
  44.  ^e3. Hexadecimal viewer
  45.  ^e4. Normal text-file viewer
  46.  ^e5. Color text-file (usually .BIN) viewer
  47.  
  48. In all the modes you can move around with the cursor keys, PgUp, PgDn etc.
  49. The ^3current file position^7 is the ^3upper left^7 character (or pixel) on
  50. the screen. Each mode is selected by pressing the number of the mode on the
  51. keyboard.
  52.  
  53. ^7In the ^3Graphic viewer^7 you can view the file as a graphical
  54. image. It's easy to learn how a sample, module or picture looks like in
  55. the gfx viewer. The ^3current file position^7 is the ^3upper left pixel^7 on the
  56. screen.
  57.  
  58. The ^3Textmode viewer^7 shows the file as an image of characters in ^d80*25 text
  59. mode.
  60.  
  61. The ^3Hexadecimal viewer^7 works somewhat like a disk editor. 
  62.  
  63. The ^3Normal text-file viewer^7 works almost like a normal text browser.
  64.  
  65. The ^3Color text-file Viewer^7 loads the file directly to screen in text-
  66. mode. The first byte that is read to screen represents a ^3color^7. The second
  67. represents an ^3ascii value^7, the next byte is a color and the next is a ascii
  68. value and so on.
  69.  
  70.  
  71. ^a2. Complete key description (works in all modes)
  72. ^2────────────────────────────────────────────────
  73.  
  74. ^eEnter    : Miscellaneous info.
  75. ^7  When you press ^3Enter^7 an info screen will appear. On this screen the
  76.   filename and file size will be available. Other things like how many bytes
  77.   one screen takes and version is also available.
  78.  
  79. ^eF1       : QuickHelp
  80. ^7  When you press ^3F1^7 the QuickHelp screen will appear.
  81.   The QuickHelp screen is viewed by a beta version of a program called 
  82.   ^3Extreme Viewer^7 which is also made by me.
  83.  
  84. ^eShift-F1 : Manual
  85. ^7  This allows you to browse in the manual (this file). ^3Extreme Viewer^7 is
  86.   also used here.
  87.  
  88. ^eF2       : Reset palette
  89. ^7  When you press ^3F2^7 you'll ^3reset the palette^7 to the default.
  90.  
  91. ^eF3       : Jump 768 bytes backwords
  92. ^7  This will ^3jump^7 ^a768^7 ^3bytes^7 (= pixels) ^3backwords^7 in the file.
  93.   The size of each ^3color^7 in a 256-color palette is ^a3^7 bytes.
  94.   Therefor the size of a 256-color palette is ^a256^7*^a3^7=^a768^7 bytes.
  95.   This can be useful when the palette of an image is before the image in the
  96.   file. You just have to get the beginning of the image on screen and jump
  97.   ^a768^7 bytes backwords in the file, and you'll have the beginning of
  98.   the palette at the current position. This function will be explained later
  99.   in this doc.
  100.  
  101. ^eF4       : Read palette
  102. ^7  This will change the current palette. It will assume that the current
  103.   position is the beginning of the palette that you want to load, and
  104.   starts reading at the current position of the file and reads ^a768^7 bytes
  105.   forward (since one 256-color palette is ^a768^7 bytes long).
  106.  
  107. ^eShift-F4 : Show current palette
  108.   This Shows the current palette in ^d320x200^7. The upper half of the screen is
  109.   vertical lines of all colors. Color ^a0^7 is leftmost and color ^a255^7 is
  110.   rightmost. The lower part of the screen is a matrix of all colors.
  111.   Color ^a0^7 is in the upper left corner and color ^a255^7 is in the lower right corner.
  112.  
  113. ^eF5       : Fill Block
  114.   This function will start at the current position and fill the file with a
  115.   chosen byte-value to chosen position
  116.   If you are at the end of the file (done by pressing ^eEND^7) and use this 
  117.   function it will ^3expand the file^7.
  118.  
  119. ^eF6       : Search for module in file
  120.   By pressing ^eF6^7 the ripper will start ^3searching for a module^7 in the file.
  121.   The ripper will start at the current position and continue searching
  122.   forward. This function searches for strings like ^dM.K.^7, ^dFLT4^7, ^dFLT8^7, 
  123.   ^d6CHN^7, ^d8CHN^7 which are located in MOD files. When a match is found you'll 
  124.   get the songname on screen and a little menu that looks like this :
  125.  
  126.   ^fs^e                 : Save module to file.
  127.   ^fj^e                 : Jump to mod position.
  128.   ^fEnter^e             : Continue search.
  129.  ^7(^fv^e                 : View module info.^7)
  130.  ^7(^fp^e                 : Play module.^7)
  131.   If the songname is something like ^3}Ωτ╘⌡Ç╞^7 then it's NOT a module, just   
  132.   a false alarm. When you've found a real module you can press ^eS^7 to save
  133.   the module to a file, or maybe press ^eV^7 to view the samplenames and other
  134.   info (this is done with a program called ^3SHOWMOD^7). You can also press ^eP
  135.   to play the module, this is done with a program called ^3Music Disk Player^7,
  136.   and it's made by ^ePSI^7 of ^eFuture Crew^7. Read the file ^3MDP.DOC^7 in the
  137.   \UTILS directory for more information about the program.
  138.  
  139. ^eF8       : Dosshell
  140.   When you press ^eF8^7 you'll ^3shell to dos^7. Just type ^eEXIT^7 to return to
  141.   ^3ByteRaper^7.
  142.  
  143. ^eF9       : Save Block
  144.   This is used to save an area from a file to a new file.
  145.   The block begins at ^3the current position^7. You will be asked for the
  146.   length of the block (in bytes) and the filename to save the block to.
  147.  
  148. ^eF10      : Find string.
  149.   This searches the file for a string given by you. By pressing
  150.   ^eTAB^7 while typing the string you can toggle between ^3case-sensitive^7 and
  151.   ^3non case-sensitive^7 search. It searches from the current position and forward.
  152.   Case-sensitive means that the search will recognize the difference between, 
  153.   for example, an "a" and an "A".
  154.  
  155. ^eESC      : Jump to next file ^7or^e quit.
  156.   If ^3wildcards^7(*,?) are specified ^eESC^7 means ^3jump to the next file^7.
  157.   If no wildcards are specified or if it's the last file in the wildcard que
  158.   ^eESC^7 will ^3quit the ripper^7.
  159.  
  160. ^eAlt-X    : Quit.
  161.   This will quit the ripper and return to DOS.
  162.  
  163. ^eKeypad + : Increase vertical screen size.
  164.   This ^3increases^7 the vertical (Y) screen size ^3with one line^7. This does not change
  165.   the graphic resolution. ^3ByteRaper^7 scrolls faster the less vertical screen-
  166.   size specified. 
  167.  
  168. ^eKeypad - : Decrease vertical screen size.
  169.   This ^3decreases^7 the vertical (Y) screen size with one line.
  170.  
  171. ^eKeypad * : Increase horizontal screen size.
  172.   This ^3increases^7 the horizontal (X) screen size ^3with one pixel^7. Note that
  173.   when this is pressed the last pixel on the first line will end up at the
  174.   beginning of the next line. These two figures try to explain what happens
  175.   when the horizontal screen size is altered. The numbers represent different
  176.   colors (or characters).
  177.  
  178.     ^3Horizontal screen size^7 = ^a8
  179.  
  180.             ^a1^72345678
  181.             ^a1^72345678
  182.             ^a1^72345678
  183.             ^a1^72345678
  184.             ^a1^72345678
  185.             ^a1^72345678
  186.  
  187.     ^3Horizontal screen size^7 = ^a7
  188.  
  189.             ^a1^7234567
  190.             8^a1^723456
  191.             78^a1^72345
  192.             678^a1^7234
  193.             5678^a1^723
  194.             45678^a1^72
  195.  
  196. ^eKeypad / : Decrease horizontal screen size.
  197.   This ^3decreases^7 the horizontal (X) screen size ^3with one pixel^7.
  198.  
  199. ^e1        : Switch to the Graphic viewer.
  200.   See the beginning of this doc for details.
  201.  
  202. ^e2        : Switch to the Textmode viewer.
  203.   See the beginning of this doc for details.
  204.  
  205. ^e3        : Switch to the Hexadecimal viewer.
  206.   See the beginning of this doc for details.
  207.  
  208. ^e4        : Switch to the Normal text-file viewer.
  209.   See the beginning of this doc for details.
  210.  
  211. ^e5        : Switch to the Color text-file (usually .BIN) Viewer.
  212.   See the beginning of this doc for details.
  213.  
  214. ^eA        : About.
  215.   When you press this an About screen with version, credits etc. appears.
  216.  
  217. ^eB        : Make Backup.
  218.   When you press this a Backup file is created called BYTERAPE.BAK.
  219.   If the file already existed then it's overwritten.
  220.  
  221. ^eC        : Run SaveCheat, SaveGame editor.
  222.   This will execute a program called ^3SAVCHEAT.EXE^7.
  223.   For more information read the ^3SAVCHEAT.DOC^7 in the \UTILS directory.
  224.  
  225. ^eG        : Garble PK-LITE header text.
  226.   If the file which is currently browsed is a ^3PK-LITE packed EXE-file^7 then a text in
  227.   the beginning of the file reveals that the file is a PK-LITE file. If this
  228.   header is garbled the program ^3still works^7, but it is difficult to see 
  229.   if the file is pk-lited or not (even pk-lite can't recognize its own file).
  230.   The info-option (^eEnter^7) will tell you if the file is pk-lited. 
  231.   This works even if the pk-lite header is garbled.
  232.  
  233. ^eH        : Add PK-LITE heder text.
  234.   If somebody has already garbeld the PK-LITE file header text then you can
  235.   recover it by using this option. You cannot add a PK-LITE header text if the
  236.   file isn't packed with PK-LITE.
  237.  
  238. ^eP        : Jump to Position.
  239.   Lets you enter a position in the file to jump to.
  240.   
  241. ^eR        : Rip current screen and/or palette.
  242.   When you press this a menu appears :
  243.  
  244.   ^eSelect what to Rip :
  245.     ^a1. ^eThe Screen and Palette as a ^BPCX
  246.     ^a2. ^eThe Screen as ^BRAW
  247.     ^a3. ^eThe Palette as ^BPAL
  248.  
  249.   Press ^e1^7 if you want to save the graphical screen as a ^3.PCX^7 file.
  250.   Press ^e2^7 if you want to save the graphical screen as a ^3.RAW^7 file.
  251.   Press ^e3^7 if you want to save the palette as a ^3.PAL^7 file.
  252.   In all these options you must also type the ^3filename without extention
  253.   for the new file.
  254.  
  255. ^eS        : Play screen as sample.
  256.   This plays the the data that is on screen as a sample. ^3Gravis UltraSound
  257.   is used to play the sample. No other cards are supported. When playing,
  258.   keypad ^e+^7 and ^e-^7 can be used to change the playing frequency. ^eEnter^3 to
  259.   toggle between ^38-bit signed^7 and ^38-bit unsigned^7 sample format. ^eESC^7 to
  260.   exit play mode. The GUS playing routines are from a pascal UNIT called ^3GUSUNIT
  261.   by a guy called ^3Oliver Fromme^7. In the ^3GUSUNIT^7 doc it is written that the
  262.   unit does ^3NOT^7 work with ^3SBOS^7 installed, but on my computer it only works
  263.   with ^3SBOS^7 installed, funny...    So try this option with, or without
  264.   ^3SBOS^7.
  265.  
  266. ^eT        : Truncate file (delete rest of file from current pos).
  267.   I can't come up with more useful help on this option then :
  268.   ^cWARNING!^3 I suggest that you know what you're doing before using this option!
  269.  
  270. ^eV        : Select video mode.
  271.   This sets up a menu with ^312 different 256 color resolutions^7. All resolutions
  272.   are ^3tweaked mode^7 routines so a ^3VGA register compatible card is needed^7. When
  273.   you choose a resolution the screen is shown in that resolution, after that
  274.   the ripper waits for a key to be pressed. When you press a key you return
  275.   to the ^3normal resolution^7.
  276.  
  277. ^eX        : Set length of lines on screen manually.
  278.   This sets the horizontal length of the lines on screen manually, that is, by
  279.   typing a number.
  280.  
  281. ^eY        : Set vertical screen length manually.
  282.   This sets the vertical length of the lines on sreen manually, that is, by
  283.   typing a number.
  284.  
  285.  
  286. ^a3. Ripping a graphical image
  287. ^2────────────────────────────
  288. ^7You start with typing ^3RIP File.Ext^7 where ^3File.Ext^7 is the file that you
  289. want to rip the graphics from. Use the cursors to search in the file for the
  290. image. When you've found it make sure that the image that you want to rip is
  291. perfectly centered on the screen. Now you want to get the right ^3palette^7.
  292. Since the palette most often starts ^a768^7 bytes before the picture, you press
  293. ^eF3^7. Now you want to grab the palette from the current position and jump back
  294. to the original position, and this is done by pressing ^eF4^7. Now, if the image
  295. is a ^a256^7 color image and the palette is located before the image you should
  296. now see the image on the screen with the right palette. If the palette is still
  297. wrong, that means that the image wasn't completely centered when you did the
  298. ^eF3-F4^7 procedure. But there can also be a problem if the image is less/more
  299. than ^d320^7 pixels wide. If the picture is less than ^d320^7, let's say ^d110^7,
  300. then you use the ^e*^7 and ^e/^7 keys on the keypad to adjust the number of
  301. pixels per line to ^a110^7. Then you repeat the ^eF3-F4^7 procedure. Sometimes
  302. the palette is also located at another position in the file. You can easily
  303. recognize a palette, since it's shown on screen in the current palette colors.
  304. Press ^eShift-F4^7 to check out the current palette. Okay, let's say that you've
  305. found the image that you want to rip, you've located the correct palette, and
  306. the image is on screen. Then just press the ^eR^7 key, and you will be asked if
  307. you want to save the image as ^dPCX^7, ^dRAW^7 or just the palette as a ^dPAL^7.
  308. In later versions of ^3ByteRaper^7 more formats will be supported.
  309.  
  310.  
  311. ^a4. Ripping a MOD file
  312. ^2─────────────────────
  313. ^7MOD files usually starts with the name of the ^3song^7. After that all the
  314. names of the ^3samples^7. After that there is a sign, for example : ^dM.K^7, ^dFLT4^7,
  315. ^d6CHN^7, ^d8CHN^7 or ^dFLT8^7. With the ^eF6^7 command ^3ByteRaper^7 searches for such strings,
  316. and when found, the program jumps back a certain amount of bytes, where the name of the song
  317. is, and tells you the name of the song, and at which position the MOD file is
  318. located. If the name of the song is just some garbage, then it's not a MOD file,
  319. just a false alarm, so keep searching. Let's say you rip the file ^3APPEAL.EXE
  320. (^3Cascada's Hex Appeal demo^7) then press the ^eF6^7 key, you will first encounter a
  321. false alarm, then a MOD file in six channel MOD called Libertine. Then you will be
  322. asked if you want to save it ^eS^7, Jump to it's position ^eJ^7, continue
  323. searching ^eENTER^7, view module info ^eV^7 (lenght, sample names etc.) or if you
  324. want to play the module ^eP^7. If you choose ^eS^7ave, ^3ByteRaper^7 will automatically
  325. calculate the lenght of the MOD file and save it. NOTE: if you've found an S3M
  326. file and you want to save it ^eByteRaper^7 will ask you how long the file is,
  327. because it does not support the S3M structure, and can therefore not calculate
  328. its lenght. This is no problem since the module doesn't have to be the correct
  329. lenght to be played, just not smaller than it's real size. So to be on the safe
  330. side just tell ^3ByteRaper^7 that it's 600kb long, and you will probably be able
  331. to play it. More info about the ^3Module Search^7 command can be found earlier
  332. in this doc.
  333.  
  334.  
  335. ^a5. How to edit the graphics in a product
  336. ^2────────────────────────────────────────
  337. If you have found an image in a file and you would like to change it to
  338. another picture, do this:
  339. Convert the picture that you want to change to to PCX. Then use the ^3PCX2RAW.EXE
  340. utility found in ^3ByteRaper's^7 ^3\UTILS^7 directory.
  341. Then run ^3ByteRaper^7 and center the image that you want to change.
  342. Then press ^eF7^7 to insert a block (your image). Then enter the name of
  343. your image and it's lenght. Note: your image and the image that you want to
  344. change must be the same resolution.
  345.  
  346.  
  347. ^a6. File List
  348. ^2────────────
  349. All these files must be included in the ByteRaper 2000 v4.0ß package :
  350.  
  351. ^eUTILS\SAVCHEAT.EXE ^3──> ^bSaveGame Cheater v1.1, you can spread program freely.
  352. ^eUTILS\SAVCHEAT.DOC ^3──> ^bDocumentation.
  353. ^eUTILS\EV.EXE       ^3──> ^bExtreme Viewer v0.1ß, may only be spread with BR2000.
  354. ^eUTILS\EV.DOC       ^3──> ^bNot ready documentation.
  355. ^eUTILS\SHOWMOD.EXE  ^3──> ^bShowMod v1.1, may only be spread with BR2000.
  356. ^eUTILS\PCX2RAW.EXE  ^3──> ^bImage converter from PCX to RAW (only 256 color pics).
  357. ^eUTILS\PCX2PAL.EXE  ^3──> ^b256 color only, you may spreas both this prog. freely.
  358. ^eUTILS\MDP.EXE      ^3──> ^bMusic Disk Player, this program is NOT made by me but FC.
  359. ^eUTILS\MDP.DOC      ^3──> ^bDocumentation to MDP by Future Crew.
  360. ^eRIP.EXE            ^3──> ^bByteRaper 2000 v4.0ß.
  361. ^eRIP.CDC            ^3──> ^bDocumentation(this file), for use by Extreme Viewer.
  362. ^eRIP.HLP            ^3──> ^bKeyboard quick-help, for use by Extreme Viewer.
  363. ^eRIP.CFG            ^3──> ^bBR2000 Config file.
  364. ^eMANUAL.BAT         ^3──> ^bRun this to view the BR2000 Documentation(this file).
  365.  
  366. All programs are made by me except the ^3Musisk Disk Player^7 which is made by
  367. ^3PSI^7 of ^3Future Crew
  368.  
  369. ^a7. Legal stuff
  370. ^2──────────────
  371. ^3ByteRaper 2000 v4.0ß is freeware. You may copy ByteRaper 2000 freely,
  372. ^3provided that none of the files are altered, and all the files are
  373. ^3included in the same package. You may not sell this program. We take no
  374. ^3responsibility for the results of using this program. All bugs should
  375. ^3be reported to the author of ByteRaper. 
  376. ^5By using this program you agree to the terms above.
  377.  
  378. PK-LITE is a trademark of PKWARE Inc.
  379. Borland Pascal 7.0 is a trademark of Borland International.
  380. SMARTDRV is a trademark of Microsoft Corp.
  381. Gravis UltraSound is a trademark of Advanced Gravis Computer Technology LTD.
  382.  
  383.  
  384. ^a8. How to contact the author
  385. ^2────────────────────────────
  386. If you want to contact me for any reason you can reach me by the following 
  387. means of communication :
  388.  
  389. ^a     Mail                   E-Mail                  Phone
  390. ^2     ────                   ──────                  ─────
  391. ^eMaciek Drejak         Dura@Svenska.Gu.Se       +46-(0)31-923319
  392. ^eEkvatorsvägen 19       Subject=Litening        Ask for Litening
  393. ^e423 38 Torslanda
  394. ^eSweden
  395.  
  396. This doc was written by ^aBLUEBiRD^7 and ^aLiTENiNG^7.
  397.  
  398.  
  399.